home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / ds_212.arc / DS_.DOC < prev    next >
Encoding:
Text File  |  1986-05-27  |  33.4 KB  |  833 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                              DIRECTORY SCANNER
  19.  
  20.                                  Ver 2.12
  21.  
  22.                                     by
  23.                              LCDR Nat Martino
  24.  
  25.                         Computer Science Deptartment
  26.                             U. S. Naval Academy
  27.                          Annapolis, MD. 21402-5002
  28.                               (301) 267-2797
  29.  
  30.  
  31.                             after 1 June 1986:
  32.  
  33.                    Pacific Missile Test Center (Code 4002)
  34.                          Point Mugu, CA 93042-5000
  35.                               (805) 989-7535
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  68.  
  69.  
  70.       ===================  DIRECTORY MOVEMENT  =====================
  71.  
  72.            The Function Keys F1 thru F8 allow the user to  move  the
  73.       directory  highlighter  from one directory to another.  Moving
  74.       the highlighter from directory to directory  does  not  change
  75.       the  user  into the newly highlighted directory until the user
  76.       strikes the carriage return [CR] key.  The directory  function
  77.       keys do the following:
  78.  
  79.         F1  -  Move  the  directory  highlighter  backward/up to the
  80.         previous directory.
  81.  
  82.         F2 - Move the directory highlighter forward/down to the next
  83.         directory.
  84.  
  85.         F3 - Move the directory highlighter to the root directory.
  86.  
  87.         F4 -  Move  the  directory  highlighter  to  the  very  last
  88.         directory.
  89.  
  90.         F5  -  Move  the  directory  highlighter  to  the  directory
  91.         displayed at the top of the display screen.
  92.  
  93.         F6  -  Move  the  directory  highlighter  to  the  directory
  94.         displayed at the bottom of the display screen.
  95.  
  96.         F7 - Scroll up the display of the directory structure.
  97.  
  98.         F8 - Scroll down the display of the directory structure.
  99.  
  100.                ************      You need to hit the
  101.                * REMEMBER *      carriage return [CR] to
  102.                ************      change/enter a directory.
  103.  
  104.            Currently there is a  limitation  of  a  maximum  of  100
  105.       directories  for  any  one  drive.  Exceeding  this limit will
  106.       result in an error message.  See "CTRL-L" option.
  107.  
  108.       ==================  FILE INDICATOR MOVEMENT  =================
  109.  
  110.            Upon  entering  a  directory  that  contains  one or more
  111.       files,  the first file in the directory is marked with 2 small
  112.       triangluar  indicators,  one  on  each  side of the file name.
  113.       This indicates which file is the current "indicated file", and
  114.       further file information about this file is displayed  at  the
  115.       bottom of the display screen.
  116.  
  117.            To  change  the  "indicated file" the file indicators are
  118.       moved from file to file through the use of  the  cursor  arrow
  119.       keys  on  the numeric keypad.  The arrow and related keys work
  120.       as follows:
  121.  
  122.          Up Arrow Key - Move to the previous file
  123.  
  124.          Down Arrow Key - Move to the next file
  125.  
  126.  
  127.  
  128.                                   - 1 -   
  129.  
  130.  
  131.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  132.  
  133.  
  134.          Left Arrow Key - Move to the file in the column to the left
  135.  
  136.          Right Arrow Key - Move to the file in  the  column  to  the
  137.          right
  138.  
  139.          Home Key - Move to the first file on the display screen
  140.  
  141.          End Key - Move to the last file on the display screen
  142.  
  143.          PgUp Key - Display previous page of file names
  144.  
  145.          PgDn Key - Display next page of file names
  146.  
  147.            The  PgUp/PgDn  keys  are  active only when the currently
  148.       displayed directory has more files than can fit  on  a  single
  149.       screen/page.
  150.  
  151.            Currently there is a limitation of a maximum of 250 files
  152.       per any one directory.  Exceeding this limit will result in an
  153.       error message.  See "CTRL-L" option.
  154.  
  155.       ========================  COMMANDS  ==========================
  156.  
  157.       ****** ATTRIBUTE TAGGED FILES ******               Option  "A"
  158.  
  159.            This option allows the user to change 3 of the  attribute
  160.       bits  on  all  files  that are tagged.  Depressing "A" with no
  161.       files tagged will result in an error  beep.  Once  files  have
  162.       been tagged this option becomes available.  Activation of this
  163.       option  will  allow the user to turn on/off the read-only bit,
  164.       the system bit and the hidden bit,  by toggling the "r",  "s",
  165.       and "h" keys respectively.  Changing the file's attribute bits
  166.       only  takes  effect when the carriage return key is depressed.
  167.       The user should toggle the attribute select keys ("r",  "s"  &
  168.       "h")  to  the desired states,  then hit the carriage return to
  169.       activate the desired changes.
  170.  
  171.       --------------------------------------------------------------
  172.  
  173.       ******* ATTRIBUTE DIRECTORY ********          Option  "CTRL-A"
  174.  
  175.            This option allows the user to change  the  same  3  file
  176.       attribute  bits  that  Option  A (above) changes,  except this
  177.       option  works  on  the  attribute  bits  of  the   highlighted
  178.       directory.  The  significance  of  changing  the  read-only or
  179.       system bits of a directory is unknown.  Turning the hidden bit
  180.       of a directory on will hide the directory from the normal  DOS
  181.       "dir"   command.   The   DS  program  can  see  the  directory
  182.       regardless of the condition of the hidden bit.  The  user  may
  183.       want  to  hide  a  directory so that other people that use the
  184.       same machine do not  rummage  through  the  hidden  directory.
  185.       This assumes the other users do not know or have access to the
  186.       DS or other programs that show the directory regardless of the
  187.       hidden   bit.   The  user  is  prohibited  from  changing  the
  188.       attribute bits on the root directory of any  drive.  All  sub-
  189.       directories  are  fair  game.
  190.  
  191.  
  192.                                   - 2 -   
  193.  
  194.  
  195.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  196.  
  197.  
  198.  
  199.       --------------------------------------------------------------
  200.  
  201.       *************  BACKUP  *************               Option  "B"
  202.  
  203.            The backup option will execute the "ds_bkup.exe" program.
  204.       It will prompt the user for the type of backup (ie:  to floppy
  205.       disks  or  to  a  second  hard  disk)  and  the  backup  drive
  206.       destination.  It will then present a display screen  identical
  207.       to  the main DS program with the exception that the "indicated
  208.       file" is now marked with only a trailing indicator.  All files
  209.       displayed will have 1 of 3 characters preceeding the filename.
  210.       The 3 characters and their significance are:
  211.  
  212.            "+" indicates the file has its archive bit set,  or  that
  213.                the user would like to set the archive bit on.
  214.  
  215.            [sp]  indicates  the  file  does not have the archive bit
  216.                  set,  or that the user  would  like  to  clear  the
  217.                  archive bit.
  218.  
  219.            "-"  indicates  that  the  user would like to delete this
  220.                 file.
  221.  
  222.           In  the  manual  mode  the  user  is  presented  with  the
  223.       opportunity  to  modify  the archive bit of a file by changing
  224.       the character preceeding the file name.  The actual changes to
  225.       the file's archive bit are  not  implemented  until  the  user
  226.       processes his/her desired changes by hitting the "p" key.  The
  227.       "p"  key  processes changes and will set/clear the archive bit
  228.       on files with "+"/[sp] respectively,  and delete  those  files
  229.       marked with a "-" preceeding the file name.
  230.  
  231.           The  actual  backup  (copying  to  backup) is done only on
  232.       those files that have their archive bit set on.  In the manual
  233.       mode,  the backup of a directory is accomplished by  the  user
  234.       pressing  the "x" key.  The "x" key will eXecute the backup of
  235.       a directory.  If there are no files in the selected  directory
  236.       that  need  backing  up (ie:  no files have their archive bits
  237.       set) then pressing "x" will appear to do nothing,  and you are
  238.       left  in  the same directory to choose additional options.  If
  239.       the directory does need backing up,  then the backup procedure
  240.       will  commence and if the backup is to floppy disks,  the user
  241.       will be prompted to enter the appropriate backup diskettes.
  242.  
  243.           The auto/manual mode refers to the  capability  of  moving
  244.       from directory to directory manually or automatically.  In the
  245.       manual mode, the user must move from one directory to the next
  246.       through the use of the F1-F8 keys and the carriage return.  In
  247.       the  auto  mode,  the backup program automatically moves on to
  248.       the next directory after it  has  completed  operations  in  a
  249.       given  directory.  The user may switch back and forth from the
  250.       manual mode and auto mode through the use of the "m"  and  "a"
  251.       keys.  To  enter  the  auto  mode  from the manual mode simply
  252.       depress the "a" key.  To enter the manual mode from  the  auto
  253.       mode simply depress the "m" key.
  254.  
  255.  
  256.                                   - 3 -   
  257.  
  258.  
  259.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  260.  
  261.  
  262.  
  263.           In  the auto mode,  if a directory requires backup and the
  264.       user is backing up to floppy disks,  the user is prompted  for
  265.       inserting  the  proper  backup  disks.  If  the  user does not
  266.       desire to backup the currently displayed directory,  the  user
  267.       may  skip  that  directory  by  depressing  the  ESC key.  The
  268.       program will then move on to the next directory and check  for
  269.       required  backups.  The  user  is  automatically placed in the
  270.       manual mode at the completion of the auto mode (ie:  when  the
  271.       auto  mode has completed processing the last directory).  Auto
  272.       mode backup to another hard disk does  not  require  prompting
  273.       for backup disks;  however, the user may still be prompted for
  274.       possible obsolete backup files (see below).
  275.  
  276.       The  backup  program maintains 3 user selectable copy options.
  277.       They are:
  278.  
  279.             Precautionary Copy - A precautionary copy is the copy to
  280.       backup of a file which did not have its archive bit  set.  The
  281.       file  is  copied to backup even though the archive bit was not
  282.       on as a precaution because the backup program could not find a
  283.       file by the same name on any  of  the  backup  disks  for  the
  284.       current directory.  The default for this option on start up is
  285.       "yes"  do precautionary copying of files where necessary.  For
  286.       this option to work correctly, the user must insert all backup
  287.       disks for a particular directory  in  the  correct  sequential
  288.       order.
  289.  
  290.             Obsolete Backups - An obsolete backup file is a file the
  291.       program finds on a backup disk but does not find a file by the
  292.       same name in the directory which the user is backing  up.  The
  293.       default  for  this  option  on start up is "identify" possible
  294.       obsolete files.
  295.  
  296.             Delete Duplicate Backups - Duplicate backups are 2 files
  297.       on 2 different backup floppy diskettes  of  1  directory  that
  298.       have  the  same name.  The default for this option on start up
  299.       is "no",  do not  delete  duplicate  backup  files.  For  this
  300.       option  to  work  correctly,  the  user must insert all backup
  301.       disks for a particular directory  in  the  correct  sequential
  302.       order.
  303.  
  304.           All 3 of the above copy options can be changed by the user
  305.       by  selecting  the  "d" (for defaults) key,  and then toggling
  306.       either the "p",  "o"  or  "d"  keys  for  Precautionary  Copy,
  307.       Obsolete Backups, and Duplicate Backups respectively.
  308.  
  309.          One of the options available while in the  manual  mode  is
  310.       the "Restore-.bat" option.  This option will construct, in the
  311.       root  directory  of  the drive to be backed up,  2 batch files
  312.       that can be used to reconstruct the  directory  structure  and
  313.       restore all backup files, should the need to reformat the hard
  314.       disk become necessary or should the user desire to switch over
  315.       to a new hard disk.  If you are backing up to floppies,  the 2
  316.       files are "ds_f1.bat" and "ds_f2.bat".  If you are backing  up
  317.       to  a  second  hard  disk,   the  files  are  "ds_h1.bat"  and
  318.  
  319.  
  320.                                   - 4 -   
  321.  
  322.  
  323.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  324.  
  325.  
  326.       "ds_h2.bat".  This option should be  executed  each  time  the
  327.       user makes some sort of change to the directory structure (ie:
  328.       mkdir/rmdir) on the hard disk in question.
  329.  
  330.       --------------------------------------------------------------
  331.  
  332.       *********  COMMAND ENTER  **********               Option  "C"
  333.  
  334.           The  command  entry  option  allows  the user to enter any
  335.       command they would enter at the  normal  DOS  command  prompt.
  336.       Whatever  is entered by the user is passed on to a second copy
  337.       of "command.com".  Upon completion  of  the  command,  the  DS
  338.       program  resumes.  This  option  allows the user to start up a
  339.       second command processor by issuing the command "command".  To
  340.       terminate the second  command  processor  the  "exit"  command
  341.       would be given.
  342.  
  343.  
  344.       --------------------------------------------------------------
  345.  
  346.       *******  COPY TAGGED FILES  ********           Option  "Alt-C"
  347.  
  348.           The  copy  tagged files option  will copy those files that
  349.       are tagged (see Option "T" below) to  a  specified  directory.
  350.       The  user  will specify the desired destination directory.  If
  351.       the user desires to make a second copy of a file in  the  same
  352.       directory, specify only the new name of the file.  If the user
  353.       specifies only a drive specification such as "a:", the program
  354.       will  copy  the  tagged files to the current directory on that
  355.       drive.  If the user does not specify a  destination  directory
  356.       but simply enters a carriage return, the program will copy the
  357.       tagged  files to the directory which is currently highlighted.
  358.       When choosing this last method of specifying  the  destination
  359.       directory,  prior to entering the carriage return the user may
  360.       change the highlighted directory with the use of the  F1  thru
  361.       F8  keys.  The  program will not allow the user to copy a file
  362.       or files to  the  same  directory  without  specifying  a  new
  363.       filename.  In other words, no copy will take place if the user
  364.       simply  enters a carriage return and the highlighted directory
  365.       also happens to be the current  directory.  This  prevents the
  366.       system from trying to copy a file onto itself and consequently
  367.       clobbering itself.
  368.  
  369.  
  370.       --------------------------------------------------------------
  371.  
  372.       **********  DRIVE CHANGE  **********               Option  "D"
  373.  
  374.           The  drive  change  option  allows the user to switch to a
  375.       different default drive and display  the  directory  structure
  376.       information of the new drive.  When switching off a hard disk,
  377.       all directory structure information about that drive and other
  378.       pertinent  program  information (ie:  current colors) is first
  379.       copied to the device driver  "ds_drive.sys"  memory  location.
  380.       This  is done so that when switching back to that hard disk it
  381.       is not necessary to do the lengthy disk I/O process to recover
  382.  
  383.  
  384.                                   - 5 -   
  385.  
  386.  
  387.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  388.  
  389.  
  390.       the disk directory structure information.
  391.  
  392.       --------------------------------------------------------------
  393.  
  394.       ******  DELETE TAGGED FILES  *******           Option  "Alt-D"
  395.  
  396.           The  delete  tagged  files  option  will allow the user to
  397.       delete those files that  have  been  tagged  (see  Option  "T"
  398.       below).  This  option  will  first request a confirmation that
  399.       the user really wants to delete all those  files  marked.  The
  400.       default  confirmation  response is "Y",  so depressing any key
  401.       except "N" (and ESC) will delete all tagged files.
  402.  
  403.       --------------------------------------------------------------
  404.  
  405.       ********  DIRECTORY RESCAN  ********         Option  "Cntrl-D"
  406.  
  407.           The directory rescan  option  will  rescan  the  directory
  408.       structure  of  the current default drive.  This option will be
  409.       necessary if you switch floppies in a floppy drive,  or add or
  410.       delete  directories  on  a  hard  disk  while executing the DS
  411.       program.  This option can be used in place of exiting  the  DS
  412.       program  and  re-entering  it  with  "ds  c" to rescan the "c"
  413.       drive.
  414.  
  415.       --------------------------------------------------------------
  416.  
  417.       ******  EDIT INDICATED FILE  *******               Option  "E"
  418.  
  419.           The edit option will allow the user to  edit  the  current
  420.       "indicated  file".  The  user  must have a file (your favorite
  421.       editor) by the name of "edit.com" or "edit.exe" in your  path.
  422.       The DS program does not provide an editor, but simply attempts
  423.       to  execute  a  .com or .exe file by the name of "edit" and if
  424.       successful,  passes to it the name of  the  current  indicated
  425.       file.  Upon termination of the editing process, the DS program
  426.       resumes where it left off.
  427.  
  428.       --------------------------------------------------------------
  429.  
  430.       ***********  FIND FILE   ***********               Option  "F"
  431.  
  432.          The find option will allow the user to search  the  current
  433.       default  drive  for  a  specified file.  The user provides the
  434.       name of the file,  which can include the "*" and "?"  wildcard
  435.       specifiers.  The  find  option  will then commence a search of
  436.       all directories starting  from  the  root  directory.  When  a
  437.       matching  file  is found in a directory,  the program stops in
  438.       that directory and  displays  the  files  of  that  directory.
  439.       Additionally,  the  matching  file  will  become  the  current
  440.       "indicated file".  This option only finds the  first  matching
  441.       file  in  the  directory.  If  there are additional files that
  442.       match  (which  is  likely  with  "*"  and  "?")  in  the  same
  443.       directory, the user must spot these additional files visually.
  444.       Additionally, the   first   matching   "indicated   file"  may
  445.       not  be  listed alphabetically first.
  446.  
  447.  
  448.                                   - 6 -   
  449.  
  450.  
  451.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  452.  
  453.  
  454.          Once the program has halted  in  a  directory  that  has  a
  455.       matching file the following options are available:
  456.  
  457.           Arrow Keys   \
  458.           Home / End    }  -   Work as they normally do
  459.           PgUp / PgDn  /
  460.  
  461.           'L' or 'l' Key   -   Will list the indicated file
  462.  
  463.           Note: Directory movement keys F1-F8 do not work here.
  464.  
  465.       The user has 3 additional options to continue/terminate:
  466.  
  467.           Esc Key  -  Continue searching directories
  468.  
  469.           F9  Key  -  Terminate search option in the currently
  470.           displayed directory.
  471.  
  472.           F10 Key  -  Terminate search option in the directory from
  473.           which the search option was started.
  474.  
  475.       If  Esc is chosen,  upon completion of the final directory the
  476.       user is placed in the original directory from which  the  find
  477.       option was activated.
  478.  
  479.       --------------------------------------------------------------
  480.  
  481.       ******  FREE ON OTHER DRIVE  *******            Option "ALT-F"
  482.  
  483.           This option will allow the user to find out the  available
  484.       space  (free  bytes) of any drive without having to switch off
  485.       the current drive.  This option would  most  appropriately  be
  486.       used  when  tagging  files  on  the  current  drive to copy to
  487.       another drive.  In this way the user can get a rough  estimate
  488.       as  to  how  many  files can be tagged and copied to the other
  489.       drive.  The number of free bytes on the other  drive  will  be
  490.       displayed  in  the lower right corner of the box border,  just
  491.       above the display of the number of bytes tagged on the current
  492.       drive.  Due to the nature of file space allocation by DOS  (in
  493.       clusters of varying sizes on different media), you will not be
  494.       able  to  copy as many bytes from one media to the other media
  495.       as specified in this option.  In other words,  expect to  copy
  496.       fewer than the number of free bytes displayed by this option.
  497.  
  498.       --------------------------------------------------------------
  499.  
  500.       ***********  HELP MENU  ************               Option  "?"
  501.  
  502.           The help menu  will  print  a  one  page  summary  of  all
  503.       available options.
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.                                   - 7 -   
  513.  
  514.  
  515.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  516.  
  517.  
  518.       --------------------------------------------------------------
  519.  
  520.       ***********  LIST FILE   ***********               Option  "L"
  521.  
  522.          The list option will allow the user to list the contents of
  523.       the current "indicated file".  The user  should  have  a  file
  524.       (your favorite lister program) by the name  of  "list.com"  or
  525.       "list.exe"  in  your  path.  If  neither  file is found in the
  526.       path,  the indicated file will be listed via  the  DOS  "type"
  527.       command.  An outstanding lister program by Vernon D.  Buerg is
  528.       available  in  the  "shareware"  environment  which  is highly
  529.       recommended for your use.
  530.  
  531.       --------------------------------------------------------------
  532.  
  533.       *****  LIMITS OF THE PROGRAM  ******           Option "CTRL-L"
  534.  
  535.           This  option  will show the user the limits of the current
  536.       "DS.EXE" program  and  its  supporting  "DS_DRIVE.SYS"  device
  537.       driver.  Normally  the user should never need to exercise this
  538.       option.   However,   should  one  of  the  program  limits  be
  539.       exceeded,  an alarm will sound and a message will be displayed
  540.       that states "Exceeded Program Limits".  The user can then  use
  541.       this  option  to  determine  which program limit was exceeded.
  542.       Hopefully the program will continue to  operate,  disregarding
  543.       the directories or files that exceeded the program limits.  As
  544.       the  size  of  the data structures supporting this program are
  545.       determined at compile time (vice  execution  time),  currently
  546.       the  only remedy for exceeding the program limits is to either
  547.       rearrange your directory/file  structure  to  conform  to  the
  548.       program limits,  or contact the author for another copy of the
  549.       program with limits extended to  values  more  appropriate  to
  550.       your particular system.
  551.           The limits for "DS.EXE" are reasonably easy to understand.
  552.       The limits for "DS_DRIVE.SYS" need some explanation.
  553.  
  554.          Number of Drives maintained:
  555.            Limit = The number of drives the driver can maintain
  556.            Used  = Show which drives the driver is maintaining
  557.               ie: C-  indicates Drive C: and no 2nd drive
  558.                   --  indicated no drives as yet retained by driver
  559.                   CD  indicates 2 drives C: & D:
  560.  
  561.          Bytes Allocated per Drive:
  562.            Limit = Maximum amount of space (bytes) allocated per Drive
  563.            Used  = How many bytes the current drive is using up in
  564.               the driver, or would use up if it is not yet maintained
  565.               by the driver.
  566.  
  567.       --------------------------------------------------------------
  568.  
  569.       *******  MOVE TAGGED FILES  ********               Option  "M"
  570.  
  571.           The move tagged files option allows the user to move those
  572.       files  tagged  (see  Option "T" below) to another directory on
  573.       the SAME drive.  Moving files from directory to  directory  is
  574.  
  575.  
  576.                                   - 8 -   
  577.  
  578.  
  579.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  580.  
  581.  
  582.       quicker and more efficient than copying all the  tagged  files
  583.       to  the  destination  directory and then deleting all the same
  584.       files from the source directory.  The user can either  specify
  585.       the  desired  destination directory or enter simply a carriage
  586.       return.  If the  user  enters  only  a  carriage  return,  the
  587.       program  will move all the tagged files to the directory which
  588.       is  currently  highlighted.   When  choosing  this  method  of
  589.       specifying the destination directory,  the user may change the
  590.       highlighted directory with  the  F1  thru  F8  keys  prior  to
  591.       entering  the carriage return.  Additionally,  the highlighted
  592.       directory must be different from the  current  directory  (the
  593.       one  in  which  the  tagged  files  are in) for this method of
  594.       entering only a carriage return to work.
  595.  
  596.       --------------------------------------------------------------
  597.  
  598.       ******  PRINT TAGGED FILES  ********               Option  "P"
  599.  
  600.           The print tagged files option allows the user to  send  to
  601.       the  print  spooler a maximum of 10 tagged files.  This option
  602.       simply sends to the standard DOS "print" command the first  10
  603.       tagged  files.   Once  sent  to  the  print  spooler,   it  is
  604.       recommended that you exit the DS program completely to enhance
  605.       or increase the speed of printing the desired  files.  If  the
  606.       user  remains  in  the  DS program,  the speed of printing the
  607.       files is drastically reduced as the print spooler must compete
  608.       with the DS program for cycle time.
  609.  
  610.       --------------------------------------------------------------
  611.  
  612.       **********  RENAME FILE  ***********               Option  "R"
  613.  
  614.           The rename option allows the user to rename the indicated
  615.       file to a new name.
  616.  
  617.       --------------------------------------------------------------
  618.  
  619.       ********  SCREEN REFRESH  **********               Option  "S"
  620.  
  621.           The  screen  refresh  option will allow the user to redraw
  622.       the entire screen.  This may become  necessary  should  a  DOS
  623.       message like "Abort, Retry or Ignor" disrupt the screen.
  624.  
  625.       --------------------------------------------------------------
  626.  
  627.       ***********  TAG FILE  *************               Option  "T"
  628.  
  629.           The  tag  file  option  is  used  as  a precursor to other
  630.       options such as  the  copy  tagged  files  option.  When  this
  631.       option  is  selected,  the  current  indicated  file is set to
  632.       reverse video and the next file becomes the current  indicated
  633.       file.
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.                                   - 9 -   
  641.  
  642.  
  643.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  644.  
  645.  
  646.       --------------------------------------------------------------
  647.  
  648.       *********  TAG ALL FILES  **********           Option  "Alt-T"
  649.  
  650.           The  tag  all  files option allows the user to tag all the
  651.       files in the current directory in preparation for execution of
  652.       another option.
  653.  
  654.       --------------------------------------------------------------
  655.  
  656.       **********  UNTAG FILES  ***********               Option  "U"
  657.  
  658.           The  untag option allows the user to untag a file that has
  659.       been tagged by mistake.
  660.  
  661.       --------------------------------------------------------------
  662.  
  663.       ********  UNTAG ALL FILES  *********           Option  "Alt-U"
  664.  
  665.           The untag all files option allows the user  to  untag  all
  666.       the files that are currently tagged.
  667.  
  668.       --------------------------------------------------------------
  669.  
  670.       *********  EXECUTE FILE  ***********               Option  "X"
  671.  
  672.           The eXecute file option allows the  user  to  execute  the
  673.       current  indicated  file if its file name extension is ".com",
  674.       ".exe",  ".bat",  or  ".bas".   Files  with  a  .com  or  .exe
  675.       extension  are executed directly (ie:  are not passed thru the
  676.       command processor so no I/O redirection  is  possible).  Files
  677.       with  a  .bat  extension  are submitted to a secondary command
  678.       processor.  Files with a ".bas"  extension  are  passed  as  a
  679.       parameter   to  the  execution  of  a  file  by  the  name  of
  680.       "basica.exe".  Prior to the execution of any of  these  files,
  681.       this  option  allows  the user to enter command line arguments
  682.       which are passed to the indicated  program  as  it  goes  into
  683.       execution.
  684.  
  685.       --------------------------------------------------------------
  686.  
  687.       *********  EXECUTE FILE  ***********           Option  "ALT-X"
  688.  
  689.           This eXecute file option is the same as the one above (X),
  690.       but allows redirection of I/O as  the  indicated  file and its
  691.       arguments are executed through the command processor.
  692.  
  693.       ======================  COLOR CHANGES  =======================
  694.  
  695.          The DS program will allow the user  with  a  color/graphics
  696.       monitor to change the color of the foreground,  background and
  697.       display border.  The following keys are used:
  698.  
  699.          Grey "+" Key  - Change/Increment the display foreground
  700.                          color.  The foreground cycles thru  16
  701.                          colors.
  702.  
  703.  
  704.                                   - 10 - 
  705.  
  706.  
  707.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  708.  
  709.  
  710.          Grey "-" Key  - Change/Increment the display background
  711.                          color.  The background cycles thru 8
  712.                          colors.
  713.  
  714.          Delete Key    - Change/Increment the display border color.
  715.                          The border cycles thru 8 colors.
  716.  
  717.            Color changes should be done while the default drive is a
  718.       hard disk so that when switching drives  the  colors  will  be
  719.       retained.  The  color  information  is written/retained in the
  720.       device driver "ds_drive.sys" memory area when shifting off the
  721.       hard disk.  If the user exits DS and then activates it  again,
  722.       the  old colors (from the previous session of DS) will be read
  723.       from the "ds_drive.sys"  memory  area  and  used  in  the  new
  724.       session.
  725.  
  726.            The initial  start  up  colors  of  the  DS  display  are
  727.       determined in one of two ways.
  728.  
  729.            1)  The  user  specifies a "set DS=0F14" statement in the
  730.       environment (most  appropriately  in  the  autoexec.bat  file)
  731.       prior  to initial execution of the program.  The set statement
  732.       will place the 'DS' variable into the environment for  program
  733.       access.  The 'DS' variable is formatted as follows:
  734.  
  735.           DS=rFBb      where  r  F  B  b  represent:
  736.             |||||
  737.             |||||- border color (0 - 7)
  738.             ||||-- Background Color (0 - 7)
  739.             |||--- Foreground Color (0 - F hex)
  740.             ||---- Recursion Level Indicator (always 0 )
  741.             |----- no spaces in variable definition
  742.  
  743.          Colors are specified as follows:
  744.  
  745.             0 = Black      8 = Gray
  746.             1 = Blue       9 = Light Blue
  747.             2 = Green      A = Light Green          -\
  748.             3 = Cyan       B = Light Cyan              \   Must
  749.             4 = Red        C = Light Red                 \ be
  750.             5 = Magenta    D = Light Magenta             / Upper
  751.             6 = Brown      E = Yellow                  /   Case
  752.             7 = White      F = High-intensity White -/
  753.  
  754.          Example:
  755.              set DS=0F14     will set foreground to Hi White  (F)
  756.                                       background to Blue      (1)
  757.                                    &  border to Red           (4)
  758.  
  759.           The easiest way to determine  the  correct  parameters  to
  760.       enter  with  the  "set  DS=0xxx"  command  is  to activate the
  761.       program,  cycle through the colors with '+' '-' and <bs> until
  762.       you have the colors you want,  then depress the CNTRL and HOME
  763.       keys simultaneously.  The "Cntrl-Home" option  will  show  you
  764.       the  correct  parameters  to  enter for the currently selected
  765.       colors.
  766.  
  767.  
  768.                                   - 11 - 
  769.  
  770.  
  771.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  772.  
  773.  
  774.  
  775.  
  776.            2) If the user does not place the 'DS'  variable  in  the
  777.       environment as described above,  the foreground and background
  778.       display colors will be the default colors in use at  the  time
  779.       the  DS  program  is  initially executed.  The border color is
  780.       choosen by the program to ensure it does not conflict with the
  781.       foreground or background colors.
  782.  
  783.  
  784.           Upon exiting the DS program the DOS  default  colors  that
  785.       were  in  use  prior  to  the execution of DS are reactivated.
  786.       Should the user desire to change the DOS default colors  prior
  787.       to exiting the DS program, the user can select the "Cntrl-End"
  788.       option.  The  "Cntrl-End" option will allow the user to retain
  789.       the current DS program colors  upon  returning  to  DOS.  This
  790.       option  requires  the  "ansi.sys"  device  driver to have been
  791.       installed at power up.
  792.  
  793.  
  794.       =======================  EXIT OPTIONS  =======================
  795.  
  796.           Two exit options are available:
  797.  
  798.           F9 -  Exit in the directory that is currently highlighted.
  799.  
  800.           F10 - Exit in the directory from which the DS program was
  801.                 originally started.
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.                                   - 12 - 
  832.  
  833.